

<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
  <meta charset="utf-8" />
  <meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />

  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  
  <title>iSCSI Initiator for Microsoft Windows &mdash; Ceph Documentation</title>
  

  
  <link rel="stylesheet" href="../../_static/ceph.css" type="text/css" />
  <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="../../_static/ceph.css" type="text/css" />
  <link rel="stylesheet" href="../../_static/graphviz.css" type="text/css" />
  <link rel="stylesheet" href="../../_static/css/custom.css" type="text/css" />

  
  

  
  

  

  
  <!--[if lt IE 9]>
    <script src="../../_static/js/html5shiv.min.js"></script>
  <![endif]-->
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></script>
        <script src="../../_static/jquery.js"></script>
        <script src="../../_static/_sphinx_javascript_frameworks_compat.js"></script>
        <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js"></script>
        <script src="../../_static/doctools.js"></script>
        <script src="../../_static/sphinx_highlight.js"></script>
    
    <script type="text/javascript" src="../../_static/js/theme.js"></script>

    
    <link rel="index" title="Index" href="../../genindex/" />
    <link rel="search" title="Search" href="../../search/" />
    <link rel="next" title="iSCSI Initiator for VMware ESX" href="../iscsi-initiator-esx/" />
    <link rel="prev" title="iSCSI Initiator for Linux" href="../iscsi-initiator-linux/" /> 
</head>

<body class="wy-body-for-nav">

   
  <header class="top-bar">
    <div role="navigation" aria-label="Page navigation">
  <ul class="wy-breadcrumbs">
      <li><a href="../../" class="icon icon-home" aria-label="Home"></a></li>
          <li class="breadcrumb-item"><a href="../">Ceph 块设备</a></li>
          <li class="breadcrumb-item"><a href="../rbd-integrations/">Ceph 块设备与第三方对接</a></li>
          <li class="breadcrumb-item"><a href="../iscsi-overview/">Ceph iSCSI Gateway</a></li>
          <li class="breadcrumb-item"><a href="../iscsi-initiators/">iSCSI Initiators 的配置</a></li>
      <li class="breadcrumb-item active">iSCSI Initiator for Microsoft Windows</li>
      <li class="wy-breadcrumbs-aside">
            <a href="../../_sources/rbd/iscsi-initiator-win.rst.txt" rel="nofollow"> View page source</a>
      </li>
  </ul>
  <hr/>
</div>
  </header>
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search"  style="background: #eee" >
          

          
            <a href="../../" class="icon icon-home"> Ceph
          

          
          </a>

          

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../../search/" method="get">
    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        
        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../start/">Ceph 简介</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../install/">安装 Ceph</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../cephadm/">Cephadm</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../rados/">Ceph 存储集群</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../cephfs/">Ceph 文件系统</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../">Ceph 块设备</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../rados-rbd-cmds/">基本命令</a></li>
<li class="toctree-l2"><a class="reference internal" href="../rbd-operations/">运维</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../rbd-integrations/">对接</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../rbd-ko/">内核模块</a></li>
<li class="toctree-l3"><a class="reference internal" href="../qemu-rbd/">QEMU</a></li>
<li class="toctree-l3"><a class="reference internal" href="../libvirt/">libvirt</a></li>
<li class="toctree-l3"><a class="reference internal" href="../rbd-kubernetes/">Kubernetes</a></li>
<li class="toctree-l3"><a class="reference internal" href="../rbd-nomad/">Nomad</a></li>
<li class="toctree-l3"><a class="reference internal" href="../rbd-openstack/">OpenStack</a></li>
<li class="toctree-l3"><a class="reference internal" href="../rbd-cloudstack/">CloudStack</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="../iscsi-overview/">LIO iSCSI Gateway</a><ul class="current">
<li class="toctree-l4"><a class="reference internal" href="../iscsi-requirements/">Requirements</a></li>
<li class="toctree-l4"><a class="reference internal" href="../iscsi-targets/">Configuring the iSCSI Target</a></li>
<li class="toctree-l4 current"><a class="reference internal" href="../iscsi-initiators/">Configuring the iSCSI Initiators</a></li>
<li class="toctree-l4"><a class="reference internal" href="../iscsi-monitoring/">Monitoring the iSCSI Gateways</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../rbd-windows/">Windows</a></li>
<li class="toctree-l3"><a class="reference internal" href="../nvmeof-overview/">NVMe-oF 网关</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../man/">手册页</a></li>
<li class="toctree-l2"><a class="reference internal" href="../api/">APIs</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../radosgw/">Ceph 对象网关</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../mgr/">Ceph 管理器守护进程</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../mgr/dashboard/">Ceph 仪表盘</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../monitoring/">监控概览</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../api/">API 文档</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../architecture/">体系结构</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../dev/developer_guide/">开发者指南</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../dev/internals/">Ceph 内幕</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../governance/">项目管理</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../foundation/">Ceph 基金会</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../ceph-volume/">ceph-volume</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../releases/general/">Ceph 版本（总目录）</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../releases/">Ceph 版本（索引）</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../security/">Security</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../hardware-monitoring/">硬件监控</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../glossary/">Ceph 术语</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../jaegertracing/">Tracing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../translation_cn/">中文版翻译资源</a></li>
</ul>

            
          
        </div>
        
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../../">Ceph</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
<div id="dev-warning" class="admonition note">
  <p class="first admonition-title">Notice</p>
  <p class="last">This document is for a development version of Ceph.</p>
</div>
  <div id="docubetter" align="right" style="padding: 5px; font-weight: bold;">
    <a href="https://pad.ceph.com/p/Report_Documentation_Bugs">Report a Documentation Bug</a>
  </div>

  
  <section id="iscsi-initiator-for-microsoft-windows">
<h1>iSCSI Initiator for Microsoft Windows<a class="headerlink" href="#iscsi-initiator-for-microsoft-windows" title="Permalink to this heading"></a></h1>
<p><strong>Prerequisite:</strong></p>
<ul class="simple">
<li><p>Microsoft Windows Server 2016 or later</p></li>
</ul>
<p><strong>iSCSI Initiator, Discovery and Setup:</strong></p>
<ol class="arabic simple">
<li><p>Install the iSCSI initiator driver and MPIO tools.</p></li>
<li><p>Launch the MPIO program, click on the “Discover Multi-Paths” tab, check the
“Add support for iSCSI devices” box, and click “Add”. This will require a
reboot.</p></li>
<li><p>On the iSCSI Initiator Properties window, on the “Discovery” tab, add a target
portal. Enter the IP address or DNS name and Port of the Ceph iSCSI gateway.</p></li>
<li><p>On the “Targets” tab, select the target and click on “Connect”.</p></li>
<li><p>On the “Connect To Target” window, select the “Enable multi-path” option, and
click the “Advanced” button.</p></li>
<li><p>Under the “Connet using” section, select a “Target portal IP” . Select the
“Enable CHAP login on” and enter the “Name” and “Target secret” values from the
Ceph iSCSI Ansible client credentials section, and click OK.</p></li>
<li><p>Repeat steps 5 and 6 for each target portal defined when setting up
the iSCSI gateway.</p></li>
</ol>
<p><strong>Multipath IO Setup:</strong></p>
<p>Configuring the MPIO load balancing policy, setting the timeout and
retry options are using PowerShell with the <code class="docutils literal notranslate"><span class="pre">mpclaim</span></code> command. The
rest is done in the iSCSI Initiator tool.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>It is recommended to increase the <code class="docutils literal notranslate"><span class="pre">PDORemovePeriod</span></code> option to 120
seconds from PowerShell. This value might need to be adjusted based
on the application. When all paths are down, and 120 seconds
expires, the operating system will start failing IO requests.</p>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Set</span><span class="o">-</span><span class="n">MPIOSetting</span> <span class="o">-</span><span class="n">NewPDORemovePeriod</span> <span class="mi">120</span>
</pre></div>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">mpclaim</span><span class="o">.</span><span class="n">exe</span> <span class="o">-</span><span class="n">l</span> <span class="o">-</span><span class="n">m</span> <span class="mi">1</span>
</pre></div>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">mpclaim</span> <span class="o">-</span><span class="n">s</span> <span class="o">-</span><span class="n">m</span>
<span class="n">MSDSM</span><span class="o">-</span><span class="n">wide</span> <span class="n">Load</span> <span class="n">Balance</span> <span class="n">Policy</span><span class="p">:</span> <span class="n">Fail</span> <span class="n">Over</span> <span class="n">Only</span>
</pre></div>
</div>
<ol class="arabic simple">
<li><p>Using the iSCSI Initiator tool, from the “Targets” tab, click on
the “Devices…” button.</p></li>
<li><p>From the Devices window, select a disk and click the
“MPIO…” button.</p></li>
<li><p>On the “Device Details” window the paths to each target portal is
displayed. If using the <code class="docutils literal notranslate"><span class="pre">ceph-ansible</span></code> setup method, the
iSCSI gateway will use ALUA to tell the iSCSI initiator which path
and iSCSI gateway should be used as the primary path. The Load
Balancing Policy “Fail Over Only” must be selected</p></li>
</ol>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>mpclaim -s -d $MPIO_DISK_ID
</pre></div>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>For the <code class="docutils literal notranslate"><span class="pre">ceph-ansible</span></code> setup method, there will be one
Active/Optimized path which is the path to the iSCSI gateway node
that owns the LUN, and there will be an Active/Unoptimized path for
each other iSCSI gateway node.</p>
</div>
<p><strong>Tuning:</strong></p>
<p>Consider using the following registry settings:</p>
<ul>
<li><p>Windows Disk Timeout</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">HKEY_LOCAL_MACHINE</span>\<span class="n">System</span>\<span class="n">CurrentControlSet</span>\<span class="n">Services</span>\<span class="n">Disk</span>
</pre></div>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">TimeOutValue</span> <span class="o">=</span> <span class="mi">65</span>
</pre></div>
</div>
</li>
<li><p>Microsoft iSCSI Initiator Driver</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">HKEY_LOCAL_MACHINE</span>\\<span class="n">SYSTEM</span>\<span class="n">CurrentControlSet</span>\<span class="n">Control</span>\<span class="n">Class</span>\<span class="p">{</span><span class="mi">4</span><span class="n">D36E97B</span><span class="o">-</span><span class="n">E325</span><span class="o">-</span><span class="mi">11</span><span class="n">CE</span><span class="o">-</span><span class="n">BFC1</span><span class="o">-</span><span class="mi">08002</span><span class="n">BE10318</span><span class="p">}</span>\<span class="o">&lt;</span><span class="n">Instance_Number</span><span class="o">&gt;</span>\<span class="n">Parameters</span>
</pre></div>
</div>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">LinkDownTime</span> <span class="o">=</span> <span class="mi">25</span>
<span class="n">SRBTimeoutDelta</span> <span class="o">=</span> <span class="mi">15</span>
</pre></div>
</div>
</li>
</ul>
</section>



<div id="support-the-ceph-foundation" class="admonition note">
  <p class="first admonition-title">Brought to you by the Ceph Foundation</p>
  <p class="last">The Ceph Documentation is a community resource funded and hosted by the non-profit <a href="https://ceph.io/en/foundation/">Ceph Foundation</a>. If you would like to support this and our other efforts, please consider <a href="https://ceph.io/en/foundation/join/">joining now</a>.</p>
</div>


           </div>
           
          </div>
          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
        <a href="../iscsi-initiator-linux/" class="btn btn-neutral float-left" title="iSCSI Initiator for Linux" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
        <a href="../iscsi-initiator-esx/" class="btn btn-neutral float-right" title="iSCSI Initiator for VMware ESX" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
    </div>

  <hr/>

  <div role="contentinfo">
    <p>&#169; Copyright 2016, Ceph authors and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0).</p>
  </div>

   

</footer>
        </div>
      </div>

    </section>

  </div>
  

  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>

  
  
    
   

</body>
</html>